NumberBox How To's

How to's for the NumberBox guide.

How to Use NumberBox?

How to Use NumberBox?

NumberBox is a component used to control numeric input within forms.
By following the steps below, you can add a NumberBox to your form and configure it according to your needs.

1. How to Add a NumberBox to a Form?

1. Open the form design screen
2. Go to the Toolbox panel
3. Locate the NumberBox component
4. Drag and drop it onto the form
5. Click the component and configure its settings from the Properties panel

2. Configuring Basic Properties

Precision

Defines how many digits can appear after the decimal point.
The NumberBox will automatically round the value up or down to match the specified precision.

Min – Max Value Setting

Used to define the allowed numeric range for user input.

Step (Increment Amount)

Specifies the step value used by the increase/decrease arrows.

Use Thousand Separator

Automatically applies a thousand separator to the entered numeric value.

3. Usage Scenarios

• Integer NumberBox for stock quantities
• Decimal NumberBox for price or amount entries
• NumberBox with min–max values for form validations
• NumberBox with decimal precision for percentage calculations

---

How to Use Do Not Round to Precision?

How to Use Do Not Round to Precision?

The NumberBox object is a form control used for numeric data entry and supports decimal precision settings.
In some scenarios, the entered value must be stored without rounding. In such cases, the Do Not Round to Precision property is used.

When Does the Property Become Visible?

The Do Not Round to Precision property:

• Becomes visible when a non-zero value is entered in the Precision field
• Is not displayed if the Precision field is empty or set to 0

Example

Precision Value	Do Not Round to Precision
0	Not Visible
2	Visible
4	Visible

What Does the Property Do?

This property is used to control decimal rounding behavior.

Behavior Comparison

Setting	Result
Do Not Round to Precision = Off	The entered value is rounded according to the Precision value
Do Not Round to Precision = On	The entered value is not rounded and is stored as-is

Usage Scenarios

It is recommended to use this property in the following cases:

• When raw values must be preserved in financial calculations
• When rounding is not desired for measurements, ratios, or scientific data
• When the user-entered value should not be altered before calculations

Example Scenario

Settings

• Precision: 2
• Do Not Round to Precision: True

User Input

• Entered value: 12.3456

Result

• Stored value: 12.3456 (not rounded)

If Do Not Round to Precision were False, the stored value would be:

• 12.35

---

How to Use Client Enabled?

What is Client Enabled?

Client Enabled is a property that defines whether a form control is active (enabled) on the client side when the form is first loaded.
If it is set to True, the control is immediately usable by the user.
If it is set to False, the control is disabled and cannot be interacted with until a specific condition or rule activates it.

This property is especially useful for controlling the user’s interaction flow and applying dynamic behaviors using the Rule Manager.

What Does It Do?

The property allows developers to:

• Control when a form control becomes interactive.
• Prevent users from entering or changing data until prerequisites are met.
• Dynamically enable or disable controls based on user input or logic.

Example Scenario — Conditional Activation

Scenario:
A form contains a checkbox called “I Accept Terms” and a text field called “Signature.”
The goal is to make the “Signature” field inactive until the user checks “I Accept Terms.”

Steps to Implement:

1. Select the “Signature” field in the form editor.

2. In the Properties panel, find the Client Enabled field.

3. Set the value to False — the field will now be disabled by default when the form loads.

4. Open the Rule Manager.

5. Add a new rule:

   Condition:

Action:

6. Save and publish the form.

Result:

• When the form loads, the “Signature” field is disabled.
• Once the user checks “I Accept Terms,” the field automatically becomes active and editable.

Behavior Summary

Property State	Description
True	The control is active and ready for user interaction when the form loads.
False	The control is disabled at load time and can be enabled dynamically via rules or code.

Notes & Best Practices

• Use the Client Enabled property to manage client-side interactivity without requiring server actions.
• Combine it with Rule Manager to define when and how controls become active.
• Remember: if server enablement is disabled, the client cannot enable the control even if Client Enabled is set to True.
• By default, this property is set to True (active).

Summary

Client Enabled improves form usability by letting developers control when and how users interact with form controls.
It is essential for creating responsive, condition-based form experiences where user actions dynamically change the form’s state.

---

What Is NumberBox?

What Is NumberBox?

NumberBox is a control component used in forms when numeric data entry is required.
It supports both integer and decimal values and provides various configuration options that allow developers to define the numeric input format.

This component is used to improve data accuracy, prevent invalid formats, and enhance the overall user experience.

Common Use Cases

• Entering quantities, counts, and numeric amounts
• Currency or values requiring decimal precision
• Percentage / ratio calculations
• Integer-based fields such as age, count, stock quantities
• Numerical fields that require validation

Features

• Integer input support
• Decimal input support
• Ability to define minimum and maximum allowed values
• Configurable decimal precision
• Increase/decrease (step) controls
• Formatting and validation options

Usage in the Development Interface

When the form is active:

1. Select NumberBox from the Toolbox section
2. Drag and drop it onto the form
3. Click the component to configure its settings under the General and Events tabs

NumberBox ensures that numerical input is entered in a controlled and reliable way.